<!--
  ~ Copyright (C) 2010 Brockmann Consult GmbH (info@brockmann-consult.de)
  ~
  ~ This program is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU General Public License as published by the Free
  ~ Software Foundation; either version 3 of the License, or (at your option)
  ~ any later version.
  ~ This program is distributed in the hope that it will be useful, but WITHOUT
  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  ~ more details.
  ~
  ~ You should have received a copy of the GNU General Public License along
  ~ with this program; if not, see http://www.gnu.org/licenses/
  -->

<html>
<head>
    <title>Sentinel-3 Toolbox - In-Situ Client (Demonstrator)</title>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <link rel="stylesheet" href="../style.css">
</head>

<body>

<p>
<table class="header">
    <tr class="header">
        <td class="header">&nbsp;
            In-Situ Client (Demonstrator)
        </td>
        <td class="header" align="right"><a href="nbdocs://org.esa.snap.snap.help/org/esa/snap/snap/help/docs/general/overview/SnapOverview.html"><img
                src="../images/snap_header.jpg" border=0></a>
        </td>
    </tr>
</table>

<h3>Introduction</h3>

<p>
    The In-Situ Client is currently an demonstrator application and not yet really useful for productive applications. Further updates will
    bring access to more in-situ server and also better ways for requesting the data. To help us to make progress in the right direction you can
    tell us your suggestions in the
    <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
        <param name="content" value="http://forum.step.esa.int/">
        <param name="text" value="<html>our forum</html>">
    </object>
    .
</p>

<p>
    Currently the In-Situ Client gives only limited access to the
    <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
        <param name="content" value="http://mermaid.acri.fr/home/home.php">
        <param name="text" value="<html>MERMAID In-situ Database</html>"></object> hosted by
    <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
        <param name="content" value="http://www.acri.fr">
        <param name="text" value="<html>ACRI-ST</html>"></object>.
    Two datasets are available , namely BOUSSOLE and AERONET-OC.
</p>

<p align="center">
<table>
    <thead>
    <tr>
        <th>Dataset</th>
        <th>Latitude</th>
        <th>Longitude</th>
        <th>Start Date</th>
        <th>End Date</th>
    </tr>
    </thead>
    <tbody>
    <tr>
        <td>AERONET-OC</td>
        <td>43.367</td>
        <td>7.9</td>
        <td>19/04/2002</td>
        <td>18/07/2002</td>
    </tr>
    <tr>
        <td>BOUSSOLE</td>
        <td>45.314</td>
        <td>12.508</td>
        <td>23/09/2003</td>
        <td>01/10/2003</td>
    </tr>
    </tbody>
</table>
<br>
<img src="../images/SatelliteImage.png"/><br/>
<span style="font-size: x-small; ">The AERONET-OC (yellow) and BOUSSOLE (red) stations</span>

<h3>The User Interface</h3>

<p>
    The user interface of the In-Situ Client allows
<ul>
    <li>to select the in-situ database to get the observations from.</li>
    <li>to select the datasets and paramets the user is interested in.</li>
    <li>to select the products which shall be provided with the in-situ observation data.</li>
    <li>to specify the temporal extent search for observations. The start and end date are updated by the selected products.</li>
    <li>to specify the spatial extent search for observations. The latitude and longitude boundaries are updated by the selected products.</li>
</ul>
<p>
    After downloading in-situ observations they are stored in the vector data nodes in each selected product if the geo-location of the
    observation is contained in the product.
</p>

<p align="center">
    <img src="../images/InsituClient.png"/><br/>
</p>

<p class="i1">
    <b>In-Situ Database:</b>
    Select the In-Situ Database the client shall connect to.
</p>

<p class="i1">
    <b>Dataset:</b>
    After connected to the In-Situ Database the user can select one or multiple of the offered datasets. No selection means all datasets.
</p>

<p class="i1">
    <b>Parameter:</b>
    After connected to the In-Situ Database the user can select one or multiple of the offered parameter. The list depends also on the selected
    datasets as different datasets offer differend parameters. No selection means all parameter.
</p>

<p class="i1">
    <b>Product:</b>
    The user can select one or multiple of the currently opened data products. The selected products will span the temporal and the spatial extent
    for the in-situ data search.
</p>

<p class="i1">
    <b>Start time:</b>
    Specifies the start time of the temporal extent.
</p>

<p class="i1">
    <b>End time:</b>
    Specifies the end time of the temporal extent.
</p>

<p class="i1">
    <b>Min longitude:</b>
    Specifies the minimum longitude value of the spatial extent.
</p>
<p class="i1">
    <b>Max longitude:</b>
    Specifies the maximum longitude value of the spatial extent.
</p>

<p class="i1">
    <b>Min latitude:</b>
    Specifies the minimum latitude value of the spatial extent.
</p>
<p class="i1">
    <b>Max latitude:</b>
    Specifies the maximum latitude value of the spatial extent.
</p>

<p><img src="nbdocs://org.esa.snap.snap.tango/tango/22x22/actions/view-refresh.png">
    Clicking on this button will display the number of in-situ observations which will be retrieved by the current query settings.
</p>
<p><img src="nbdocs://org.esa.snap.snap.tango/tango/22x22/actions/document-save.png">
    Clicking on this button the download of the in-situ observations is initiated. Before the actual download is performed you have to
    <a href="#dataPolicyWindow">accept the data policies</a> of the datasets.
</p>
<p>
<img src="nbdocs://org.esa.snap.snap.tango/tango/22x22/apps/help-browser.png">
    Clicking on this button will open this help page.
</p>

<a name="dataPolicyWindow"><h3>Data Policy Window</h3></a>
<p>
    Before downloading the data a window is displayed in which you have to accept the data policy for each dataset which requires it.
    You can also save all data policies to one file for later use when you want to acknowledge and cite the dataset.
    If you don't accept the data policies or cancel the dialog the in-situ observations are not downloaded.
</p>
<p align="center">
    <img src="../images/DataPolicyWindow.png"/><br/>
</p>


<h3>Result</h3>
<p>
    The downloaded in-situ observations are stored in vector data nodes. For each parameter of each dataset one vector data node is created.
    The following screen shot gives an overview how a product equiped with in-situ observations looks like.
</p>
<p align="center">
    <img src="../images/ResultScreenshot.png"/><br/>
</p>

<hr>
</body>
</html>
